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Cromemco Software Update Service Note 68000 Cromix-1l 


Date: August 30,1982 


Product :_CRO-DL_ and CRO-DS_ 
Version.Release: _20,05 
Date production of this version began: Aug. 27, 1982 on 8” 
Aug, 27, 1982 on 5 
First serial number with this version: _ ]1-100]12 on 8" 
1-10070 on 5" 


SUMMARY 

This version of the Cromix™ Operating System is the first 
version configured for use with Cromemco's new Dual Processor 
Unit (DPU) and its associated 16 bit memory boards. The 
boards are the Memory Control Unit (MCU), and 265K and 512K 
Memory Storage Units (256MSU and 512MSU). These boards are 


described in the June 1982 Cromemco 68000 Board Family 
Instruction Manual, part number 023-2016. 


The 68000 Cromix Operating System gives you the ability to 
run programs for both the Z80 and 68000 microprocessors. You 
may thus take advantage of the power offered by the 68000 
while still maintaining compatibility with the large software 
base established for the 280. 


This note describes the differences between the 68000 Cromix 
Operating System, version 20.05, and the 280 Cromix Operating 
System, version 11.11. Most of the differences exist at the 
level of the operating system's interaction with the hardware 
and are not apparent at the user level. The June 1982 Cromix 


. Instruction Manual, part number 023-4022, should be used as 


the primary reference for user operation. 


To further supplement the Cromix Instruction Manual, copies 
of the following SUDS notes for the Cromix Operating System 
have been included in this package: Cromix-4, part number 
023-9532, and Cromix-5, part number 023-9540. 


Future versions of the Cromix Operating System will grow to 


- take greater advantage of the 68000 microprocessor. Users 


eer 


023-9548 


are urged to subscribe to the Software Update Service (SUDS) 
to keep appraised of changes to the 68000 Cromix Operating 
System and to receive new releases of the software. To 
become a SUDS subscriber, contact your Cromemco dealer. 
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HARDWARE CONFIGURATION 


This version of the Cromix software requires at least the 
following boards for proper operation: a DPU, an MCU, one or 
more MSUs, and a disk controller board. 


Any hard disk drives used with the system must be controlled 
by a WDI-II Winchester Disk Interface board, revision B or D. 
Failure to use the proper controller board will jeopardize 
the data on your hard disk. 


NEW SOFTWARE 
Crogen68.bin version RB 00.00 


This utility generates a 68000 Cromix operating system. It 
allows you to add or delete system drivers and to select 
various options when you configure the system. Crogen68 is 
located in the /gen directory. 


This 68000 version of Crogen operates in the same manner as 
the Z80 version, which is documented in the Cromix 
Instruction Manual. 


Cromix.sys version 20.05 


This file contains the 68000 operating system configured by 
Crogen68. During the boot procedure, this file is read into 
the system portion of memory. 6 


Ecc.bin version RB 00.02 


Ecc is a 68000 Cromix utility used with the Cromemco 256MSU 
and 512MSU memory boards, which have the ability to perform 
memory error detection and correction. This program allows a 
privileged user to enable or disable memory error correction 
hardware and to display on the console the type and location 
of memory errors. Error correction is disabled when the 
system is reset and must be normally reenabled. 


cae 
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Ecc has the following command formats and capabilities: 


Ecc on Turns on error correction, 
Ecc off Turns off error correction. 
Ecc Reports if error correction is off or on. 


Ecc -e Reports any errors since the last Ecc -e. If there 
are no errors, nothing is displayed on the console. 


If memory errors are Suspected, you may want to accumulate an 
error history. The command file /emd/logerr.cmd is provided 
for this purpose. It periodically checks whether any memory 
errors have occurred since the last check. Errors are 
written to the file /etc/msu_errs. 


Generate an error history by typing on your console the 
command 


logerr nn & 


where nn is the desired number of seconds between each Ecc 
check of the error status. The ampersand places the command 
file execution in background. 


In this version of the Cromix Operating System, error 
correction MUST be turned off when using Hdtest or any other 
program which directly accesses the hard disk (i.e., programs 
which don't use Cromix system calls). Disk related Cromix 
System calls disable error correcting for their duration. 
Failure to turn error correction off while performing DMA to 
a hard disk will jeopardize the data on the hard disk. 


Init version 02.76 


The 68000 Cromix software includes a new version of Init, 
which has two enhancements: 


The disk RPM test now works with MSUs when initializing hard 
or floppy disks. MSU error correction is automatically 
disabled while initializing a hard disk, preventing conflicts 
between the error correction and DMA, 


CNTRL-C characters are now trapped by: Init, making it 
impossible to interrupt Init once started. Previously, when 
initializing a hard disk, the alternate track table would be 
destroyed if the program received a CNTRL-C character during 
initialization. 
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68000 Abort Codes 
When the 68000 encounters an error condition, it generates an 
error code and begins exception processing based on the type 
of error. A message such as 

Vector interrupt - 03 4E720002 00394E73 00000000 30740002 
will be displayed on the console. If this happens type 
CNTRL-C,. In many cases, this will return control to the 
operating system. If, however, the processor was in 
supervisor mode, CNTRL-C will have no affect and the system 
will have to be reset. 
The two digits at the far left of the numbers above, 03 are 
the error code. Look up this code in the following table and 
take the appropriate debugging action. 
The hexadecimal numbers to the right of the error code 
represent the contents of the top 16 bytes of the system 
stack at the time the error was encountered, This . 
information is pushed: on the system stack during exception [ 
processing and may be useful in debugging. The first two : 
bytes represent the contents of the status register. The 
next long word represents the contents of the program 
counter. 
The following table defines run time errors generated by the 
68000: 
Vector Address 
number Dec Hex Assignment 

0 0 000 Reset: initial system stack pointer 

1 4 004 Reset: initial program counter 

2 8 008 Bus Error 

3 12 00c Address Error 

4 16 010 Illegal Instruction 

5 20 014 Zero Divide 

6 24 018 CHK Instruction 

7 28 01C TRAPV Trnstruction 

8 32 020 Privilege Violation 

9 ' 36 024 Trace 

10 40 028 Line 1010 Emulator 

11 


44 02c' | Line 1111 Emulator 
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68000 Memory Usage 


The addressing capability of the 68000 and the 
availability of new higher-capacity memory boards has 
lead to a vertical arrangement of 68000 Cromix memory. 
That is, memory is treated as one block in which memory 
addresses increase from the bottom to the top of memory. 
280 Cromix memory, on the other hand, is arranged 
horizontally in banks of 64K bytes. 


The 68000 Cromix Operating System has been adapted from 
the 280 Cromix Operating System, so some sections are 
written in 280 code and are executed by the 280. 
Remaining sections are written in 68000 code and are 
executed by the 68000. 


68000 Cromix memory is divided into two parts, user 
memory and system memory. The system memory is further 
divided into three parts: 64K bytes which contain the 
portion of Cromix software written in 68000 code, 64K 
bytes which contain the 280 portion of the software, and 
the upper 64K bytes which provide memory mapped I/O for 
the 68000. User memory is divided into 64K byte 
sections one for each user. 


Memory allocation for Z80 jobs is the same as with 280 
Cromix software. Jobs for the 68000, however, may be as 
large as available memory will allow. The number of 
available shell buffers, which depend on the options 
selected in generating the operating system, may be less 
than the number available with the 280 Cromix software. 


The 68000 generates 24 bit addresses and can directly 
address any portion of memory. The 280 outputs 16 bit 
addresses, which comprise the low order 16 bits of 24 
bit memory addresses. The upper eight bits of this 
address are contained in an address latch on the DPU 
board. The contents of this latch are set to the high 
order eight bits of the last op-code fetched by the 
68000, This is the op-code that initiates 280 
processing. 


The following is a graphic representation of 68000 
Cromix memory usage: 
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68000 Cromix System Calls 


The same set of system calls available under the 280 Cromix 
Operating System are available under the 68000 Cromix 
Operating System, with the exception of nine calls which 
remain to be implemented in the next version. System calls 
used by the 68000 are identical in function to corresponding 
Z80 system calls. The Cromix Instruction Manual describes 
the function of each call. Since these calls are being 
implemented on the 68000, however, their use of 68000 
registers needs to be defined. 


Upon encountering an error, the system call sets the carry 
flag and deposits an error code in register DO. The 
following table lists each 68000 system call, its call 
number, its calling parameters, and its return parameters. 
An asterisk following the name of a call indicates that the 
call has not yet been implemented. 
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System 
Number 


Calli 


ng 


Parameters 


type of device 
major device # 
minor device # 


D1 = 


access mode 
exclusive mode 
AO -> pathname 


D2 = 
D3 = 


error number 


Other registers as 
returned by the call 
that generated the 


error 


channel 


access mask 


channel 


status type 
new value 


channel 


-> new pathname 


channel 


desired info 
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face nnn t------- tun—---- te ecn nn + 
| System | System| Calling | Return | 
| Call | Number| Parameters | Parameters | 
toece ene tenn $-- +--+ $owe ee + 
| exec * | 4CH | AO -> pathname | | 
| | | Al -> argument list | | 
a $—------ penn n = + +++ fren nn - + 
| exit | 46H | D3= termination status] | 
Sa +-—-----— fo -- tu---- ~~~ +--+ + 
| _faccess | 26H | D2 = access mask | | 
| | | AO -> pathname | | 
$oen n+ $------- to--------- +--+ +--+ fron + 
| _fchstat * | 22H | D2 = status type | | 
| | | D3 = new value | | 
| | | AO -> pathname | | 
| | | Al -> buffer | | 
to-------- +--+ +------- foe ene + foe nnn + 
| _fexec * | 4BH | Dl = signal mask | | 
| | | D2 = signal values | | 
| | | AO -> pathname | | 
| | | Al -> argument list | | 
oe tome toon -- +--+ fone ee + 
| _flink | 24H | AO -> old pathname | | 
| | | Al -> new pathname | | 
to-------------- t——----- torn nnn ne pone n ++ + 
| _fshell * | 48H | Dl = signal mask | | 
| | | D2 = signal values | | 
| | | AO -> pathname | | 
| | | Al -> argument list | | 
pr rena = +------- +--------------+----- +--+ toon nnn +--+ + 
| _fstat * | 20H | D2 = desired info | D3 = return value | 
| | | AO -> pathname | | 
| | | Al -> buffer | | 
fron ee += +------- t--------- +--+ + $on- +--+ + + 
| getdate | 30H | | DO = day of the week | 
| | | | Dl = year | 
| | | | D2 = month | 
| | | | D3 = day of the month | 
$e---------- = +-~------ rene + Steet ated + 
| _getdir | 02H | AO -> buffer | | 
tonne tena ten------------ penn -- +--+ + + 
| _getgroup | 36H | D2 = id type | D3 = group id | 
trom -- +------ = tone +--+ -- + panne + 
| _getmode | 12H | Dl = channel | D3 = return value | 
| | | D2 = mode type | | 
been ------ +------- tonne forme ne + 
ij ~getpos | 10H | Dl = channel | D3 = file position | 
foe - = ----- + to------ $-------- +--+ - + -- freee + + 
| —getprior | 38H | | D3 = priority number | 
$oce nen $o------ +---------- +--+ +--+ , eieniatentatent ceecteteeatete teenies eet 


aa 
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too ~~ ----- +------- $---~------------------- S gpetias Ghann tay ime © 
| System | System| Calling | Return ce 
| Call | Number| Parameters | Parameters | 
toon = +------- ton - ~~ - +--+ + pone - + 
| _getproc | 3AH | D3 = process id | | 
too—— $o--—--- to--—----- +--+ + fon nn + 
| _gettime | 32H | | Dl = hour | 
| | | | D2 = minute | 
| | | | D3 = second | 
ee to—----- foo--- = +--+ fon n nn + 
| _getuser | 34H | D2 = id type | D3 = user id | 
te~------------- tren t---- +--+ +--+ + + fren n nn + 
| indirect | 51H | DO = call number | Registers are used | 
| ‘ | | Registers are used | according to call | 
| | | according to call | number, | 
| | | number | | 
poe ++ +----~--+------- - + $a oa + 
| kill | 41H | D2 = signal type -{ | 
| | | D3 = process id ie | 
te------ +--+ += +------- t-------~- +--+ +--+ toon - + 
| —lock | 3EH | D2 = lock type | | 
| | | D3 = lock length | | 
| | | AO -> lock sequence | | 
poe ---------- t—------ $----------~--- ---- = - +------------~---------- + 
| _makdev | 00H | D2 = type of device | | 
| | | D3 = major device # 2 _ 
| | | D4 = minor device # | ol 
| | | AO -> pathname | 
+-------- ~~~ tran ne t-------------- + - = pon + 
| _makdir | 018 | AO -> pathname | | 
Se t------- +----~------------------- | sestetaattanteietentaieeteedeteetatetetetetetatoe + 
| _mount | 04H | Dl = type of access | | 
| | | AO => dummy pathname | | 
| | | Al -> device pathname | | 
5 re te--—--- fone + toon + + 
|} —mult | MULU D1,D0 | | 
tenn +------- +--~-~------~------------ s nateenteneatetantesatenteteetentetetentetetetetrtes + 
| _open | 09H | D2 = access mode | Dl = channel | 
| | | D3 = exclusive mode | | 
| | | AO -> pathname | | 
forme n ene nee +--~----- foe ----- +--+ teen e- +--+ + 
"| pause | 44H | | | 
$---------- ++ +—------ tenn a + 
| _pipe | OEH | = | Dl = input channel | 
| | | | D2 = output channel | 
Ss atasteatetententeatententeatentententeahe +------- hem nnn nn nnn tonne: thes ye a a oe + 
| _printf | 1BH | Dl = channel | | 
{ | {| AO -> control string | | 
| | | arguments on stack | | 
fon - tonn-- toe - + + 


10 
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Se +------- t--~----- ~~ + foe ne + 
| System | System] Calling | Return | 
| Call | Number| Parameters | Parameters | 
Se +------- tro--- +--+ +--+ s aanteniaatetanentenertenteteteetetetetetetetetiees + 
| _rdbyte | 168 | Dl = channel | DO = byte | 
peor e--- +--+ t------- t------------------ +--+ freon + 
| _rdline | 18H | Dl = channel | D3 = bytes read | 
| | | D3 = maximum bytes | | 
| | | AO -> buffer | 
+----------- +--+ +------- +-------------- ~~ +--+ $o---- ~~ = + 
| _rdseq | 148 | Dl = channel | D3 = bytes read | 
| | | D3 = maximum bytes | | 
| | | AO -> buffer | | 
$o- ~~ -- +------- +----------------+~+----- $oeo ne + + 
| _setdate | 31H | Dl = year | | 
| | | D2 = month | | 
| : | | D3 = day of the month | | 
fre----- +--+ +------- poe + + tenn ee + + 
| _setdir | 03H | AO -> pathname | | 
$o-- ee to------ +---------~------------- pon nne—- + 
| _setgroup | 37H | Dl = type to change | | 
| | | D2 = new id type | | 
| | | D3 = new group id | | 
$e een n= t------- teen ------ +--+ +--+ s sestententesestetestontoetentontentantertet tet + 
| _setmode | 13H | Dl = channel | old value | 
| | | D2 = mode type | | 
| | | D3 = new value | | 
| | | D4 = mask | | 
teen -n------ Steet to--------- + s ealentenientntentenieetaeaete teeters + 
| _setpos | 11H | Dl = channel | 
| | | D2 = mode | | 
| | D3 = file pointer | | 
$a +------- towne ~~ + seal eater + 
| _setprior | 39H | D3 = priority number | | 
5 +------- tenon + peoen-- + -- -- -- + 
|  _settime | 33H | D1 = hour | | 
| | | D2 = minute | | 
| | | D3 = second | | 
to----- + $oen = ten ----------- + poe + + 
| _setuser | 35H | Dl= type to change | | 
| | | D2= new id type | | 
| | | D3 = new user id | | 
Se ++------ toon +--+ $e onan +--+ + 
| _shell * | 49H | Al -> argument list | | 
t--------~------ +------- tenn ae -- teen + -- -- + 
| _signal * | 40H | D2 = type of signal | | 
| | | AO => execution addr. | | 
5 eee +------- to-2- +--+ +--+ + fren nen + 
| _trunc | ODH | Dl = channel | | 
$o- ea t------- tenn nn +--+ + tonne + + 
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te-----~-------- +------- fan rn ee mr te etek eo a 

| System | System| Calling | Return | 
| Call | Number! Parameters | Parameters | 
pone po------ [ooo fone nnn + 
| unlock | 3FH | D2 = lock type | | 
| | | D3 = lock length | | 
| | | AO -> lock sequence | | 
pone na + $------- fone nn fo nee - == + 
| unmount | 05H | D2 = eject flag | | 
| | | AO -> device pathname | | 
poenn-——-- a fone ++ fone + 
| update | 52H | | | 
Se +------- to enn—---- +--+ + tonne + 
| version | 55H | | D3 = version number | 
$o---- + fonee ne fo cn ne fo anne + 
| _wait | 45H | D2 = conditional flag | Dl = process term. -— | 
| | | D3 = process id | D2 = system term. | 
| l | | D3 = child pid | 
$oene- + pone $-------- +--+ fran ne + 
| _wrbyte | 17H | DO = byte | | 
| | | Dl = channel | | 
tonne nee $-—----= foeen------ +--+ ++ to----- +--+ + + 
| _wrline | 19H | Dl = channel | D3 = bytes written | 
| | | AO => buffer | | 
force ene $------- fone nn + pone + 
| _wrseq | 15H | Dl = channel | D3 = bytes written 
| | | D3 = byte count | | 
| | | AO -> buffer | | 
foe ene nee $a------ ee ee fo ------- = - = + 
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TEMPORARY RESTRICTIONS ON THIS VERSION 


The following capabilities are not supported by this version 
of the 68000 Cromix Operating System, but will be added in 
succeeding versions: 


Color Graphics 


Default 


KSAM 


Shell Buffers 


System calls 


The addressing of color graphics memory 
boards currently assumes horizontal memory 
organization and must be reconfigured. 


This 280 Cromix command setting default 
parameters for automatic login is not 
implemented in this version. 


The KSAM package has not yet been adapted 
to run under the 68000 Cromix Operating 
System. 


Currently, there are a limited number of 
shell buffers available, the actual number 
depending on how the operating system is 
generated. Succeeding versions will have 
more shell buffers. 


The following system calls are not 
implemented in this version: 


Exec 
Fexec 
Shell 
Fshell 
Cstat 
Fstat 
Cchstat 
Fehstat 
Signal 


VERSION NUMBER SUMMARY 


Files in / 


cromix.iop.sys 
cromix.sys 


Files in /bin 


access.bin 
backup.bin 
blink.bin 
boot.bin 
cdoscopy.bin 


Version 


20.05 
20.05 


—-new- 
-new- 


Version 


00.06 : 
00.08 
~ 00.13 
00.02 
00.15 
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chowner.bin 00.06 
cmpasc.bin 00.05 
compare.bin 00.07 
copy.bin 00.10 
cptree.bin 00.07 
day.bin 01.02 
dcheck. bin 00.12 
deltree.bin © 00.03 
dump. bin 00.10 
ecc.bin 00.02 -new- 
echo.bin 00.05 
ed.bin 01.35 
find.bin 00.07 
free.bin 00.09 
group.bin 00.01 
h.bin 00.04 
help.bin 00.04 
icheck.bin 00.15 
idump.bin 00.06 
init.com 02.76 -new- 
input.bin 01.00 
l.bin 00.11 
mail.bin 00.06 
makdev.bin 00.07 
makfs.bin 00.13 
maklink.bin 00.04 
match.bin 00.03 
mode.bin 01.12 
mount.bin 00.13 
move.bin 00.09 
msg.bin 00.08 
ncheck.bin 00.09 
passwd.bin 00.09 
patch.bin 00.03 
priv.bin 00.07 
restore.bin 00.05 
root.bin 00.02 
screen.bin 01.35 
sim. bin 00.34 
sort.bin 00.06 
spool.bin 00.12 
tee.bin 01.02 
testinp.bin 01.01 
time.bin 00.07 
unmount. bin 00.11 
usage.bin ~ 00.06 
version. bin 00.09 
wboot. bin 00.09 


who.bin ‘00.06 


14 


Files in /dev 
iop/cromix.iop 
iop/ioprun.bin 
Files in /etc 
fdboot 
login.bin 
sfdboot 

Files in /gen 


crogen68.bin 
default.bin 
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Version 


li.1l 
03.00 


Version 


00.09 
00.02 
00.09 


Version 


00.00 -new- 
00.01 


